home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / gcc / ixemuldc.lha / ixemul / zic.doc < prev   
Text File  |  1996-03-31  |  12KB  |  331 lines
  1.  
  2.  
  3.  
  4. ZIC(8)                                                     ZIC(8)
  5.  
  6.  
  7. NNAAMMEE
  8.        zic - time zone compiler
  9.  
  10. SSYYNNOOPPSSIISS
  11.        zziicc  [  --vv  ]  [  --dd  _d_i_r_e_c_t_o_r_y  ]  [  --ll _l_o_c_a_l_t_i_m_e ] [ --pp
  12.        _p_o_s_i_x_r_u_l_e_s ] [ --LL _l_e_a_p_s_e_c_o_n_d_f_i_l_e_n_a_m_e ] [ --ss ] [ --yy _c_o_m_m_a_n_d
  13.        ] [ _f_i_l_e_n_a_m_e ... ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        _Z_i_c  reads text from the file(s) named on the command line
  17.        and creates the time conversion information  files  speci-
  18.        fied  in  this  input.   If  a _f_i_l_e_n_a_m_e is --, the standard
  19.        input is read.
  20.  
  21.        These options are available:
  22.  
  23.        --dd _d_i_r_e_c_t_o_r_y
  24.               Create time conversion  information  files  in  the
  25.               named  directory rather than in the standard direc-
  26.               tory named below.
  27.  
  28.        --ll _t_i_m_e_z_o_n_e
  29.               Use the given time zone as local  time.   _Z_i_c  will
  30.               act  as  if  the input contained a link line of the
  31.               form
  32.  
  33.                    Link _t_i_m_e_z_o_n_e       localtime
  34.  
  35.        --pp _t_i_m_e_z_o_n_e
  36.               Use the  given  time  zone's  rules  when  handling
  37.               POSIX-format  time zone environment variables.  _Z_i_c
  38.               will act as if the input contained a link  line  of
  39.               the form
  40.  
  41.                    Link _t_i_m_e_z_o_n_e       posixrules
  42.  
  43.        --LL _l_e_a_p_s_e_c_o_n_d_f_i_l_e_n_a_m_e
  44.               Read leap second information from the file with the
  45.               given name.  If this option is not  used,  no  leap
  46.               second information appears in output files.
  47.  
  48.        --vv     Complain  if  a year that appears in a data file is
  49.               outside the range of years representable by _t_i_m_e(2)
  50.               values.
  51.  
  52.        --ss     Limit  time values stored in output files to values
  53.               that are the  same  whether  they're  taken  to  be
  54.               signed  or  unsigned.   You  can use this option to
  55.               generate SVVS-compatible files.
  56.  
  57.        --yy _c_o_m_m_a_n_d
  58.               Use the given _c_o_m_m_a_n_d rather than  yyeeaarriissttyyppee  when
  59.               checking year types (see below).
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZIC(8)                                                     ZIC(8)
  71.  
  72.  
  73.        Input  lines  are made up of fields.  Fields are separated
  74.        from one another by any number of white space  characters.
  75.        Leading  and  trailing  white  space  on  input  lines  is
  76.        ignored.  An unquoted sharp character  (#)  in  the  input
  77.        introduces  a comment which extends to the end of the line
  78.        the sharp character appears on.   White  space  characters
  79.        and  sharp characters may be enclosed in double quotes (")
  80.        if they're to be used as part of a field.  Any  line  that
  81.        is  blank (after comment stripping) is ignored.  Non-blank
  82.        lines are expected to be  of  one  of  three  types:  rule
  83.        lines, zone lines, and link lines.
  84.  
  85.        A rule line has the form
  86.  
  87.             Rule  NAME  FROM  TO    TYPE  IN   ON       AT    SAVE  LETTER/S
  88.  
  89.        For example:
  90.  
  91.             Rule  US    1967  1973  -     Apr  lastSun  2:00  1:00  D
  92.  
  93.        The fields that make up a rule line are:
  94.  
  95.        NNAAMMEE    Gives  the  (arbitrary)  name  of the set of rules
  96.                this rule is part of.
  97.  
  98.        FFRROOMM    Gives the first year in which  the  rule  applies.
  99.                Any  integer  year  can be supplied; the Gregorian
  100.                calendar is assumed.   The  word  mmiinniimmuumm  (or  an
  101.                abbreviation) means the minimum year representable
  102.                as an integer.  The word mmaaxxiimmuumm (or an  abbrevia-
  103.                tion)  means  the maximum year representable as an
  104.                integer.  Rules can describe times  that  are  not
  105.                representable  as  time  values, with the unrepre-
  106.                sentable times ignored; this allows  rules  to  be
  107.                portable  among  hosts  with  differing time value
  108.                types.
  109.  
  110.        TTOO      Gives the final year in which  the  rule  applies.
  111.                In addition to mmiinniimmuumm and mmaaxxiimmuumm (as above), the
  112.                word oonnllyy (or an  abbreviation)  may  be  used  to
  113.                repeat the value of the FFRROOMM field.
  114.  
  115.        TTYYPPEE    Gives  the type of year in which the rule applies.
  116.                If TTYYPPEE is -- then the rule applies  in  all  years
  117.                between  FFRROOMM  and TTOO inclusive.  If TTYYPPEE is some-
  118.                thing else, then _z_i_c executes the command
  119.                     yyeeaarriissttyyppee _y_e_a_r _t_y_p_e
  120.                to check the type of a year:  an  exit  status  of
  121.                zero  is  taken  to  mean  that the year is of the
  122.                given type; an exit status of one is taken to mean
  123.                that the year is not of the given type.
  124.  
  125.        IINN      Names  the  month  in which the rule takes effect.
  126.                Month names may be abbreviated.
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ZIC(8)                                                     ZIC(8)
  137.  
  138.  
  139.        OONN      Gives the day on  which  the  rule  takes  effect.
  140.                Recognized forms include:
  141.  
  142.                     5        the fifth of the month
  143.                     lastSun  the last Sunday in the month
  144.                     lastMon  the last Monday in the month
  145.                     Sun>=8   first Sunday on or after the eighth
  146.                     Sun<=25  last Sunday on or before the 25th
  147.  
  148.                Names  of  days  of the week may be abbreviated or
  149.                spelled out in full.  Note that there must  be  no
  150.                spaces within the OONN field.
  151.  
  152.        AATT      Gives  the  time  of  day  at which the rule takes
  153.                effect.  Recognized forms include:
  154.  
  155.                     2        time in hours
  156.                     2:00     time in hours and minutes
  157.                     15:00    24-hour format time (for times after noon)
  158.                     1:28:14  time in hours, minutes, and seconds
  159.  
  160.                Any of these forms may be followed by the letter ww
  161.                if the given time is local "wall clock" time, ss if
  162.                the given time is local "standard" time, or uu  (or
  163.                gg  or  zz)  if the given time is universal time; in
  164.                the absence of an indicator, wall  clock  time  is
  165.                assumed.
  166.  
  167.        SSAAVVEE    Gives  the  amount  of  time  to be added to local
  168.                standard time when the rule is  in  effect.   This
  169.                field   has  the  same  format  as  the  AATT  field
  170.                (although, of course, the ww and ss suffixes are not
  171.                used).
  172.  
  173.        LLEETTTTEERR//SS
  174.                Gives the "variable part" (for example, the "S" or
  175.                "D" in "EST" or "EDT") of time zone  abbreviations
  176.                to  be  used when this rule is in effect.  If this
  177.                field is --, the variable part is null.
  178.  
  179.        A zone line has the form
  180.  
  181.             Zone  NAME                GMTOFF  RULES/SAVE  FORMAT  [UNTIL]
  182.  
  183.        For example:
  184.  
  185.             Zone  Australia/Adelaide  9:30    Aus         CST     1971 Oct 31 2:00
  186.  
  187.        The fields that make up a zone line are:
  188.  
  189.        NNAAMMEE  The name of the time zone.  This is the name used in
  190.              creating  the  time  conversion information file for
  191.              the zone.
  192.  
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ZIC(8)                                                     ZIC(8)
  203.  
  204.  
  205.        GGMMTTOOFFFF
  206.              The amount of time to add to  GMT  to  get  standard
  207.              time  in  this zone.  This field has the same format
  208.              as the AATT and SSAAVVEE fields of rule lines;  begin  the
  209.              field  with  a minus sign if time must be subtracted
  210.              from GMT.
  211.  
  212.        RRUULLEESS//SSAAVVEE
  213.              The name of the rule(s) that apply in the time  zone
  214.              or,  alternately,  an amount of time to add to local
  215.              standard time.  If this field  is  --  then  standard
  216.              time always applies in the time zone.
  217.  
  218.        FFOORRMMAATT
  219.              The  format for time zone abbreviations in this time
  220.              zone.  The pair of characters %%ss  is  used  to  show
  221.              where the "variable part" of the time zone abbrevia-
  222.              tion goes.  Alternately, a slash (/) separates stan-
  223.              dard and daylight abbreviations.
  224.  
  225.        UUNNTTIILL The  time  at  which  the  GMT offset or the rule(s)
  226.              change for a location.  It is specified as a year, a
  227.              month,  a day, and a time of day.  If this is speci-
  228.              fied, the time zone information  is  generated  from
  229.              the  given GMT offset and rule change until the time
  230.              specified.
  231.  
  232.              The next line must be a  "continuation"  line;  this
  233.              has  the  same  form  as a zone line except that the
  234.              string "Zone" and the name are omitted, as the  con-
  235.              tinuation  line  will  place information starting at
  236.              the time specified as the UUNNTTIILL field in the  previ-
  237.              ous  line  in  the  file  used by the previous line.
  238.              Continuation lines may contain an UUNNTTIILL field,  just
  239.              as zone lines do, indicating that the next line is a
  240.              further continuation.
  241.  
  242.        A link line has the form
  243.  
  244.             Link  LINK-FROM        LINK-TO
  245.  
  246.        For example:
  247.  
  248.             Link  Europe/Istanbul  Asia/Istanbul
  249.  
  250.        The LLIINNKK--FFRROOMM field should appear as  the  NNAAMMEE  field  in
  251.        some  zone line; the LLIINNKK--TTOO field is used as an alternate
  252.        name for that zone.
  253.  
  254.        Except for continuation lines, lines  may  appear  in  any
  255.        order in the input.
  256.  
  257.        Lines  in  the  file  that describes leap seconds have the
  258.        following form:
  259.  
  260.  
  261.  
  262.                                                                 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ZIC(8)                                                     ZIC(8)
  269.  
  270.  
  271.             Leap  YEAR  MONTH  DAY  HH:MM:SS  CORR  R/S
  272.  
  273.        For example:
  274.  
  275.             Leap  1974  Dec    31   23:59:60  +     S
  276.  
  277.        The YYEEAARR, MMOONNTTHH, DDAAYY, and HHHH::MMMM::SSSS fields  tell  when  the
  278.        leap  second  happened.  The CCOORRRR field should be "+" if a
  279.        second was added or "-" if a second was skipped.  The  RR//SS
  280.        field  should  be (an abbreviation of) "Stationary" if the
  281.        leap second time given  by  the  other  fields  should  be
  282.        interpreted  as  GMT  or (an abbreviation of) "Rolling" if
  283.        the leap second time given by the other fields  should  be
  284.        interpreted as local wall clock time.
  285.  
  286. NNOOTTEE
  287.        For  areas with more than two types of local time, you may
  288.        need to use local standard time in the  AATT  field  of  the
  289.        earliest  transition time's rule to ensure that the earli-
  290.        est transition time recorded in the compiled file is  cor-
  291.        rect.
  292.  
  293. FFIILLEE
  294.        /usr/local/etc/zoneinfo standard  directory  used for cre-
  295.        ated files
  296.  
  297. SSEEEE AALLSSOO
  298.        newctime(3), tzfile(5), zdump(8)
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                                                 5
  329.  
  330.  
  331.